lstrcmpiW

Compares two wide-character strings. The comparison is not case sensitive.

Syntax

int lstrcmpiW(
    LPCWSTR lpszString1,
    LPCWSTR lpszString2
);

Parameters

lpszString1

Pointer to the first null-terminated wide string to be compared.

lpszString2

Pointer to the second null-terminated wide string to be compared.

Return Value

Returns a negative value if the function succeeds and the string that lpszString1 points to is less than the string that lpszString2 points to. Returns a positive value if the string that lpszString1 points to is greater than the string that lpszString2 points to. Returns zero if the strings are equal.

Remarks

The lstrcmpiW function compares two wide strings by checking the first characters against each other, the second characters against each other, and so on until it finds an inequality or reaches the ends of the strings.

The function returns the difference of the values of the first unequal characters it encounters. For instance, lstrcmpiW determines that L"abcz" is greater than L"abcdefg" and returns the difference of L'z' and L'd'.

The language (locale) is treated as always being English.

See Also

• String Functions